IntelliJ IDEAでBigQueryへの接続を設定する

kobayashi.m

2021.06.16

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

はじめに

データアナリティクス事業本部のkobayashiです。

IDEとしてJetBrainsのIntellijを愛用しています。2021.1バージョンがリリースされていたのですがなかなかアップデートする機会がなく、この度アップデートしたところIntellij内のDB管理ツールであるDataGridの接続でBigQueryが正式にサポートされていました。この接続設定を行ってみましたのでその内容をまとめます。

DataGrip 2021.1 の新機能 | JetBrains

DataGridでのBigQuery接続設定

以前でもDataGridでは汎用のデータソース設定としてJDBCドライバを使って各データソースへの接続は行え、BigQueryもJDBCドライバを入手すれば以下の方法で設定は行えました。

JetBrains公式ブログによるDataGridのBigQueryへの接続方法の解説 Using BigQuery from IntelliJ-based IDE | The DataGrip Blog

自分も今まではこの方法で接続していましたが、Advancedタブに値を入れなくてはならなかったりして設定に苦労した覚えがあります。今回、正式にサポートされたことで設定項目がわかりやすくなりそのような苦労はなくなったと思います。

では設定を行います。

コネクションの作成

手順1) Intellijを開きDatabase > Data Source でデータソースの設定画面を開き、BigQueryテンプレートを選ぶ。

画像では自分で以前作成したJDBCドライバを使った設定テンプレートが残っています。

サービスアカウント認証を使った設定

手順2）BigQueryへの接続設定の画面が開くので初めての設定の場合は左下のDownloadを押下しドライバをダウンロードする。次に必要な設定値を入力する。

Host : 既定値のまま
Port : 443
Project ID : 接続を行いたいBigQueryのプロジェクトIDを入力
OAuthType : 接続方法を入力
URL : OAuthTypeに従った値を入力

ここでOAuthTypeなのですが、次の４パターンがあります。

0 : サービスアカウントでの認証
1 : ユーザーアカウントでの認証
2 : アクセストークンとリフレッシュトークンでの認証
3 : アプリケーションのデフォルトの資格情報での認証

はじめ「1」のユーザーアカウントでの認証で設定を行ったのですが、使い勝手がイマイチでしたので「0」のサービスアカウントでの認証を行いました。こちらの設定方法のが個人的にはおすすめです。他の認証方法に関してはまだ試していないので機会があれば行ってみたいと思います。

各設定値でURLへ設定する値は変わるのですが、詳細はドキュメント（BigQuery | DataGrip ）がありますのでそちらをご確認ください。

サービスアカウントでの認証を選択した場合にはURLに次の値を入力します。サービスアカウントは事前に適切なロールを割当てて作成しておきます。

jdbc:bigquery://https://www.googleapis.com/bigquery/v2:443;ProjectId={Project ID};OAuthType=0;OAuthServiceAcctEmail={サービスアカウントのメールアドレス};OAuthPvtKeyPath={サービスアカウント秘密鍵のファイルパス};

設定はこれで終わりですので左下のTest Connectionを押下し設定が問題なければ以下の表示が出ます。

ここで一度設定画面を閉じてから再度設定画面を開くとURLで設定した値がテキストボックスで表示されます。個人的な感想として、できればOAuthTypeをSelectBoxで選択できて、その選択肢でそれ以降の入力値が変わると更に使い勝手が良くなると思います（以前に比べればこれでも十分使い勝手は向上しているのですが）。